From: Hong Xu <hong@topbug.net>
Date: Mon, 28 Oct 2019 15:20:43 +0000 (+0100)
Subject: Add doc for goto-history-element
X-Git-Tag: archive/raspbian/1%29.2+1-2+rpi1^2~5^2~19^2~1236
X-Git-Url: https://dgit.raspbian.org/%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:///%22http:/www.example.com/cgi/%22https:/www.github.com/%22bookmarks:/?a=commitdiff_plain;h=70578e077765825980d4dbffc0e1542f01df15ef;p=emacs.git

Add doc for goto-history-element

* doc/lispref/minibuf.texi (Minibuffer Commands): Add
goto-history-element (bug#37948).
* lisp/simple.el (goto-history-element): Clarify NABS.
---

diff --git a/doc/lispref/minibuf.texi b/doc/lispref/minibuf.texi
index dd51181db00..d5a16014053 100644
--- a/doc/lispref/minibuf.texi
+++ b/doc/lispref/minibuf.texi
@@ -2334,6 +2334,12 @@ This command replaces the minibuffer contents with the value of the
 contents of the minibuffer before the point.
 @end deffn
 
+@deffn Command goto-history-element nabs
+Puts element of the minibuffer history in the minibuffer.  The
+argument @var{nabs} specifies the absolute history position in
+descending order, where 0 means the current element and a positive
+number N means the Nth previous element.
+@end deffn
 
 @node Minibuffer Windows
 @section Minibuffer Windows
diff --git a/lisp/simple.el b/lisp/simple.el
index 184d4eccdb9..fca90690a5f 100644
--- a/lisp/simple.el
+++ b/lisp/simple.el
@@ -2128,7 +2128,9 @@ the end of the list of defaults just after the default value."
 
 (defun goto-history-element (nabs)
   "Puts element of the minibuffer history in the minibuffer.
-The argument NABS specifies the absolute history position."
+The argument NABS specifies the absolute history position in
+descending order, where 0 means the current element and a
+positive number N means the Nth previous element."
   (interactive "p")
   (when (and (not minibuffer-default-add-done)
 	     (functionp minibuffer-default-add-function)